home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_1
/
listem31.zip
/
LISTEM.DOC
< prev
next >
Wrap
Text File
|
1992-04-16
|
9KB
|
261 lines
============================= LISTEM ==============================
Searchlight BBS File Directory Lister
Copyright(C) 1991,92 BiBass Software, by Kevin Bass
ALL RIGHTS RESERVED
- WHAT IS LISTEM
This program reads one or more Searchlight BBS file directories (as
defined in FILEDIR.SL2) and creates an all file listing in
alphabetical order to standard output. Command line options can be
provided to specify what directories to process, to limit the listing
to certain directories, to display new files for the week or month, or
to search for particular files. The final result can be printed to the
monitor screen, redirected to a text file or the printer, or piped
into another process.
- LISTEM FEATURES
* Include or exclude single directories.
* Include or exclude a list of directories via indirect file list.
* Toggle long descriptions on. Default is off.
* Reformat long descriptions to 3 lines of 40 characters. Default is
2 lines of 60 characters.
* Create weekly or monthly lists.
* Use different header files for special lists.
* Redirect output. However, if redirection is not allowed, LISTEM can
create an output file for you.
* Create a list by doing case-insensitive string searches on file
names and descriptions.
* Fast and flexible!
AND MUCH MORE!
- LISTEM ARCHIVE FILE CONTENTS
The LISTEM package consists of six disk files. Make sure you have
them:
(x's donate version number)
LISTEMxx.EXE - The executable file.
LISTEM.KEY - KEY file needed to run LISTEM.
LISTEM.DOC - Basic instruction manual for LISTEM.
REGISTER.FRM - Registration form for LISTEM.
DISTRIB.TXT - List of distribution BBS for BiBass Software.
Page 1
LISTEM - Copyright(C) 1992 BiBass Software. ALL RIGHTS RESERVED.
- COPYRIGHT AND LICENSE INFORMATION
LISTEM and its documentation are Copyright(C) 1992 BiBass Software, all
rights reserved worldwide. They may not be circulated in any
incomplete or modified form, nor sold for profit, without written
permission of the author. The use of LISTEM is subject to the
following terms:
PERSONAL USE. Individuals who use LISTEM must register their copy if
they find the program useful. A registration form is provided for
your convenience. If you want to be sure of obtaining the LATEST
version of LISTEM, you can download the archive file LISTEMxx.ZIP from
one of the three primary distribution sites:
1. Kev's Korner - Quinlan, Texas (903) 883-4753.
If you have any questions or comments about LISTEM, please write.
Address all correspondence to the author:
Kevin Bass
Route 3 Box 368A-1
Quinlan, Texas 75401 USA
DISCLAIMER: You undertake to use LISTEM at your own risk. The author
assumes no liability for damages of any kind resulting from the use of
LISTEM.
- REQUIREMENTS
* MS-DOS 3.1 or higher.
* Searchlight 2.0 or higher.
- SETTING UP LISTEM
1. Place a copy of LISTEMxx.EXE in your BBS data directory (directory
that contains FILEDIR.SL2).
- SYNTAX
The syntax for running LISTEM is as follows:
LISTEM [parameters]
The following command line parameters can be used:
[access] Maximum access level (Default is 255)
[=string] Search string (Case-insensitive)
[+dir] Display directory "dir" (Default is ALL)
[-dir] Display all directories except "dir"
[+@file.ext] Display directories in list (TEXT)
[-@file.ext] Display all directories except in list (TEXT)
[!file.ext] Specify header file (Default is LISTEM.HDR)
Page 2
LISTEM - Copyright(C) 1992 BiBass Software. ALL RIGHTS RESERVED.
[*file.ext] Alternate way of specifying output file.
[/E] Display extended descriptions
E followed by a R will reformat extended
descriptions
[/D] Process by date.
D followed by W means process by week.
D followed by M means process by month.
All parameters are optional. If no parameters are given all
directories processed and displayed.
If [access] is included, LISTEM will process only directories with
an access level less than or equal to the specified number. A
number from 0 to 255 should be specified. For example:
> LISTEM 100
will omit any directories with access levels of 101 or greater from
the final list.
If [=string] is included, only files and descriptions containing this
search string will be printed in the final list. It's case-
insensative. For example, use the following to list all files on your
system with the string "scan" in their filename or description:
> LISTEM =SCAN (or scan)
The [+dir] option, where "dir" is the name of the directory, indicates
that ONLY these directories will be included in the list. For example,
to get a quick look at your letter 'UPLOADS' directory from the command
line, you would type this:
> LISTEM +UPLOADS
If [-dir] is included, these directories will be excluded from the
list. For example, you want to list all directories except in the
"GENERAL" directory:
> LISTEM -GENERAL
The [+@file.ext] and [-@file.ext] options allow you to specify an
external list of directories to include or exclude. The list is stored
in the text file specified (EXAMPLE: If the file is GRAPHICS.TXT,
specify +@GRAPHICS.TXT or -@GRAPHICS.TXT). The file should contain an
ASCII list of directory names, one per line.
If an access level parameter is used together with a "+" or "-"
parameter, the options will work together; only directories which meet
both specifications of both parameters will be displayed. You can use
"+" and "-" together.
If [!file.ext] is included, this header file will be used and shown
at the front of the list. The default is LISTEM.HDR. This is
Page 3
LISTEM - Copyright(C) 1992 BiBass Software. ALL RIGHTS RESERVED.
useful if you use different header files for different lists. For
example, let's say you are going to use a specified header file for
your program file listing called "PROGRAM.HDR":
> LISTEM !PROGRAM.HDR
If [/E] is included, long descriptions will be displayed. You also can
use [/ER] to reformat long descriptions. 4 lines of 40 characters
looks more appealing than 1 line of 40 characters and 2 lines of 60
characters in my opinion.
If [/Dx] is included, a weekly or monthly files lists will be created.
[/DW] creates weekly, while [/DM] creates monthly. This can be used to
create a weekly or monthly new files lists. Lists will be created a
week or month back respectively from the time LISTEM is executed.
- HOW DO I REDIRECT MY LIST TO A FILE?
If you want to redirect your list to a file, you provide the following
command:
> LISTEM >ALLFILES.TXT
If you want to create the list in your upload directory, you would do
the following (assuming your upload directory is on drive D: and called
"UPLOAD"):
> LISTEM >D:\UPLOAD\ALLFILES.TXT
Under some operation systems, redirection is not allowed. Using
[*file.ext] will allow you to specify the name of your output file
list. For example, to create an output file called ALLFILES.TXT, do
the following:
> LISTEM *ALLFILES.TXT
- HOW DO I REGISTER MY COPY OF LISTEM?
If you use LISTEM longer than 30 days, you need to register your copy.
Please fill out the registration from (REGISTER.FRM) and send to me
along with your payment. Upon receiving your registration fee, I will
create a registered KEY file for you to download from my BBS. If you
are FIDOnet or SLnet compatible, I will NETmail your key to you.
- ACKNOWLEDGMENTS
* Turbo Pascal is a trademark of Borland International, Inc.
* Searchlight is a trademark of Searchlight Software by Frank LaRosa.
* IBM is a trademark of International Business Machine Corporation.
* MS-DOS is a trademark of MicroSoft Corporation.
Page 4
LISTEM - Copyright(C) 1992 BiBass Software. ALL RIGHTS RESERVED.